更改日志表

如果已禁用更改跟踪，但您尝试查看跟踪的更改，则系统会显示以下提示：

如果您单击是，则会打开更改日志。如果您单击否，则不会打开更改日志。

如果已启用日志记录，则对模型进行更改时会记录每项更改。

这包括添加、删除或恢复组件，以及对组件的各个属性进行更改。这还包括使用建模器执行同步或对数据表中的列进行全局编辑。每项单独更改都会记录在日志中。

更改日志能以表格视图显示这些更改的详细信息。

打开更改日志时，系统会自动读取日志文件并将其加载到表格中。您随时可以停止读取。最新更改在表格中显示在最前面。

更改日志列

列	描述
时间戳	这是将操作添加到日志文件时的日期/时间。表格中的日期/时间以当地时间表示。存储日期/时间以 Unix UTC 表示。
ID	这是组件的 ID。
类型	组件类型。
标签	行的组件的当前标签。如果 ID 不再可用（在压缩之后删除），标签将显示为 <deleted>。如果组件已删除但 ID 仍可用，标签将显示为 <deleted: [label]>。
更改类型	这是对组件进行的更改。更改类型包括已添加、已删除、已恢复和已更改。
上下文	用于更改的上下文。这包括但不限于建模器、负荷计算工具、简化器、常规编辑以及撤消/重做。
字段	已更改的字段的标签。
新值	为该字段设置的新值。
方案	方案的标签。
可选类型	可选类型的标签。
可选 ID	更改的分项选择的 ID。
分项选择	分项选择的标签。
用户	进行更改时的用户名。这是 Windows 用户名（如果未登录到 CONNECTION Client）或 CONNECTED 用户名。

更改日志工具栏按钮

	刷新	单击刷新按钮可从 SQLite 数据库检索最新日志条目。可将最后一个日志条目的时间戳用作起点。
	复制	单击复制工具栏按钮可将当前选择的表格复制到剪贴板。下拉菜单提供在复制到剪贴板时包括标题的选项。
	过滤器	打开过滤器对话框，使您能够过滤更改日志。
	存档	最初会显示不再提示对话框，用于确认用户是否要将当前日志条目存档。如果选中不再提示选项，则假定用户回答是，从而不显示提示。要重置此选项，请从选项对话框中打开提示对话框。提示如下所示：将当前位于视图中的更改日志条目存档至 SQLite 数据库。复制行之后，相应的条目将被从当前的水力模型数据库中删除。如果选择某个现有文件，则会删除该文件，并在 SQLite 数据库中使用包含相应更改日志条目的单个表格重新创建该文件。存档过程在开始后就无法取消。存档过程无法撤消。存档过程完成后，系统会向用户显示以下提示：
	缩放	在绘图中缩放所选行的组件（如果该组件仍存在）。
	查找	打开查找对话框，用于在更改日志中搜索文本。以斜体显示的灰色文本不可搜索。
	在绘图中选择	在绘图中选择更改日志中的所选行。其他选项包括添加至选择、从选择中删除、在当前选择范围内选择、选择时打开和在所有行上打开。
	帮助	打开更改日志帮助。

更改日志表中以斜体显示的灰色文本

对于部分日志条目，您可能会看到以斜体显示的灰色文本，而不是标准文本。这些是特殊文本，表示某些情况。

<已添加>	以下列中会显示文本 <added>：Field、Scenario、Alternative Type和Alternative。NewValue列和Alternative ID列为空。仅对更改类型已添加显示。
<已删除>	以下列中会显示文本 <deleted>：Field、Scenario、Alternative Type和Alternative。NewValue列和Alternative ID列为空。仅对更改类型已删除显示。
<已修改>	以下列中会显示文本 <modified>：Scenario、Alternative Type和Alternative。仅在修改字段标签、注释、GIS-ID 和 GIS-ID (已分隔) 且更改类型为已修改时显示。
<已恢复>	以下列中会显示文本 <restored>：Field、Scenario、Alternative Type和Alternative。NewValue列和Alternative ID列为空。仅对更改类型已恢复显示。

更改日志过滤器

以下列中会显示文本 <restored>：Field、Scenario、Alternative Type和Alternative。NewValue列和Alternative ID列为空。仅对更改类型已恢复显示。

可用的过滤器如下：

过滤器	描述	示例 WHERE 语句
时间戳	将更改日志过滤到介于两个日期之间的特定时间或某个周期（过去 x 分钟、小时、天、周、月或年）内。一周为 7 天；一个月为 30 天；一年为 365 天。	Last 1 day(s) (from August 1) TimeStamp > '07/31/2017' Between July 1, 2017 and July 31, 2017 TimeStamp > '07/01/2017 12:00 AM' AND TimeStamp < '07/31/2017 03:33 PM'
组件(ID)	更改日志中的唯一 ID 列表。	ElementID IN (30,31,32)
组件类型	更改日志中的唯一组件类型列表。如果在列表中选择一种或多种组件类型，还会将组件(ID)过滤器和组件(标签)过滤器的唯一值过滤掉，并仅包括属于指定类型的 ID 和标签。	ElementTypeLabel IN ('PRV')
组件(标签)	更改日志中的唯一组件标签列表。	ElementLabel IN ('PMP-1','PMP-2')
更改类型	更改日志中的唯一更改类型列表。	ChangeType IN ('Modified','Restored')
上下文	更改日志中的唯一上下文列表。	ContextLabel IN ('ModelSize500Pipe')
字段	更改日志中的已修改唯一字段列表。	FieldLabel IN ('Start Node')
方案	更改日志中的唯一方案列表。	ScenarioLabel IN ('Base')
可选类型	更改日志中的唯一可选类型列表。	AlternativeTypeLabel IN ('Topology')
分项选择	更改日志中的唯一分项选择列表。	AlternativeLabel IN ('Base Topology')
用户	更改日志中的唯一用户列表。	User IN ('Kris.Culin','Kristopher Culin')

如果您启用多个过滤器，WHERE 子句会将各个过滤器合并为单个过滤器。例如，如果您按组件类型、组件(标签)和更改类型进行过滤，则合并后的 WHERE 子句如下所示：

ElementTypeLabel IN ('PRV','Reservoir','Tank') AND ElementLabel IN ('Reservoir') AND ChangeType IN ('Added')

将 WHERE 子句放入更改日志对话框底部的文本字段后，可以手动修改它。如果您不想使用IN（将查找包含以下列表的行），可将其更改为NOT IN（将排除使用相应项的行）。

ElementTypeLabel IN ('PRV','Reservoir','Tank') AND ElementLabel IN ('Reservoir') AND ChangeType NOT IN ('Added')

通过做出上述更改，将查找类型为减压阀、水库和水箱且标签为水库但更改类型为未添加的条目。

过滤器行为

组件(ID)和组件(标签)：

对于组件(ID)过滤器和组件(标签)过滤器，需要手动加载唯一值。唯一 ID 和标签的数目可能非常大，因此完成此过程可能需要一些时间。在加载这两个过滤器的唯一值之前，最好先过滤日志。

所有其他过滤器：

所有其他过滤器的刷新按钮都较小，位于右上角。默认行为是刷新过滤器，以基于更改日志的当前视图显示唯一值。您也可以基于整个更改日志检索所有唯一值，方法是使用下拉按钮并单击获取所有可用的唯一值菜单项。